MuleSoft Accelerator for Retail icon

MuleSoft Accelerator for Retail

(0 reviews)

B2C setup guide

The following document provides guidance on how to configure your B2C Commerce instance to provide access to the Data and Shopper APIs used by the B2C Commerce System API implementation template.

API Client ID settings

Before doing anything with the Salesforce Commerce API, you need an API Client ID. The API Client ID is a credential that is granted from Account Manager, which consists of both an ID value and a secret. Both the ID and the secret should be protected and treated as a username and password combination to using the Salesforce Commerce API.

In Account Manager, create a new API Client with the following settings:

  • Roles: Salesforce Commmerce API role with access to the target instance
  • OpenID Connect allowed scopes:
      sfcc.orders
      sfcc.orders.rw
      sfcc.products
      sfcc.products.rw
      sfcc.shopper-baskets-orders
      sfcc.shopper-baskets-orders.rw
      sfcc.shopper-myaccount
      sfcc.shopper-myaccount.rw
      sfcc.shopper-myaccount.addresses
      sfcc.shopper-myaccount.addresses.rw
      sfcc.shopper-customers.register
      sfcc.customerlists.rw
  • Token Endpoint Auth Method: client_secret_post
  • Access Token Format: JWT

Refer to the Add an API Client ID documentation in the Commerce Cloud Infocenter for more information.

Open Commerce API settings

OCAPI is the other set of APIs used by the implementation template. These settings are configured in Business Manager, on the Administration -> Site Development -> Open Commerce API Settings page. There are two groups of APIs that must be configured: Shop APIs and Data APIs. Access to Shop APIs must be configured at the Global (organization-wide) level, while access to Data APIs can be configured globally or at the individual site level.

Shop APIs

Access to the following resources and methods of the Shop APIs is required:

ResourceMethods
/customersPOST
/customers/*GET/PATCH
/customers/*/addressesGET/POST
/customers/*/addresses/*GET/PATCH/DELETE
/customers/*/basketsGET
/customers/*/ordersGET
/orders/*GET/PATCH
/order_searchPOST
/product_listsGET
/product_lists/*GET/PATCH
/product_lists/*/itemsGET/POST
/product_lists/*/items/*PATCH/DELETE
/product_searchGET
/product_search/availabilityGET
/product_search/imagesGET
/product_search/pricesGET
/product_search/variationsGET
/products/*GET
/products/*/imagesGET
/products/*/availabilityGET
/products/*/pricesGET
/products/*/variationsGET

Data APIs

Access to the following resources and methods of the Data APIs is required:

ResourceMethod
/products/*GET/PUT/PATCH
/products/*/variation_attributes/*GET/PUT
/products/*/variation_attributes/*/values/*GET/PUT
/products/*/variations/*GET/PUT
/product_searchPOST
/inventory_lists/*/product_inventory_records/*GET/PATCH/PUT
/catalogs/*/categories/*/products/*GET/PATCH/PUT
/sites/*/orders/**PUT/PATCH

Reviews

TypeCustom
OrganizationMulesoft Inc.
Published by
MuleSoft Solutions
Published onSep 27, 2021
Contact nameMuleSoft Solutions
Contact emailsolutions-questions@mulesoft.com
Asset overview

Asset versions for 2.2.x

Asset versions
VersionActions
2.2.1
2.2.0